RCRT_ Results Type

RCRT_ values apply only to recognizers compatible with version 1.0 of the Pen API. They are used in the wResultsType member of the RCRESULT232HBID structure, which specifies the type of results as described in the following table:

Constant

Description

RCRT_ALREADYPROCESSED

Set by a hook if the result has already been acted upon. If an application receives a result with this bit already set, it should erase the ink and perform no other pro-cessing. An application-wide hook can set this flag. The Hform sample application demonstrates its use.

RCRT_DEFAULT

Normal return type.

RCRT_GESTURE

Result is a gesture symbol.

RCRT_NORECOG

Nothing recognized; only the data is returned. No recognition was attempted.

RCRT_NOSYMBOLMATCH

Nothing recognized. The ink drawn did not match any enabled symbols.

RCRT_PRIVATE

Recognizer-specific symbol recognized.

RCRT_UNIDENTIFIED

Result contained unidentified results.

 

Example

The code below shows an example of how to use RCRT_ values:

if ((lpr->wResultsType & (RCRT_NOSYMBOLMATCH | RCRT_ALREADYPROCESSED |

                                      RCRT_NORECOG | RCRT_PRIVATE ) ) == 0 )

     // A gesture or character

     if (lpr->wResultsType & RCRT_GESTURE)

    

                 .

                 .           // Handle Gesture

                 .

     }

     else

    

                 .

                 .           // Character results

                 .

     }

}

else

     .           // Handle special cases as necessary.  In general,

     .           // should just ignore.  This is what hedits do.

     .

}